home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1994 / MacHack 1994.toast / MacHack™ 1987-1994 / MacHack™ '87 / DA's / Comments DA / Comments.doc < prev    next >
Text File  |  1986-02-11  |  3KB  |  43 lines
  1. "Comments" is a desk accessory that lets you read, write, or modify
  2. the comments normally found in the Finder's "Get Info" box -- but 
  3. you don't have to return to the Finder to do it!  This short doc
  4. explains two things about the DA that might not be obvious other-
  5. wise:  how to install the (optional) special menu cursor (the file
  6. "Cmnts.crs" that accompanies the accessory; and the slightly non-
  7. standard but, I think, amusing user interface it uses.
  8. 1.  Installation:  you install "Cmnts.bin" as you would any other
  9. desk accessory, using either Apple's Font/DA Mover, or with the
  10. Resource Editor (ResEdit) available in DL8 of MacDev.  You may,
  11. if you wish, use ResEdit to install also (into the System file)
  12. the cursor resource called "Cmnts.crs"; the DA will work fine
  13.  without it, however. Its resource ID is 5; so if you do install 
  14. it, be sure you don't already have a cursor resource with this 
  15. ID# (most Systems have just the standard 4).
  16. 2.  Use:  The DA window has a light grey background and a white
  17. rectangle within it where comments appear and are modified by
  18. you.  When you move the mouse over this rectangle, the cursor is
  19. the I-beam shape, meaning you can edit the text appearing in the
  20. rectangle.  When the cursor is outside the white rectangle but
  21. within the DA's window, it changes shape (to a miniature menu if
  22. you installed "Cmnts.crs", otherwise to a cross).  Mouse down now
  23. and a menu pops up where the mouse was clicked (thanks to Mike
  24. Schuster: see MacTutor vol 1 #12)!  Choose "Comment" from the menu
  25. to get a list of all the files, both applications and documents,
  26. on any mounted disk -- this is just your basic SFGetFile dialog 
  27. box.  Pick a file, and if there's a comment appended it will
  28. appear in the DA window's white rectangle.  You can now modify it;
  29. if the file had no comment you'll only see TextEdit's flashing
  30. vertical bar.  You can type a new comment if you wish.  In either
  31. case (modifying an old comment or adding a new one), you need to
  32. pop up the menu and choose "Save" to associate the new comment 
  33. with the file.  Choose "Comment" again to see another file.
  34. 3.  One last caveat:  this version won't work with any Finder later
  35. than 4.1, meaning no HD20's, Mac+s, or other HFS systems need apply.
  36. When I get plussed (RSN I hope) I will post a version that will work
  37. with both MFS and HFS systems.
  38. 4.  I've tested "Comments" with most of my commonly used applications,
  39. and with TMON's Trap Discipline and Heap Scramble routines.  It seems
  40. solid, but...I am an amateur programmer, so please exercise prudence
  41. and get to know the thing before you entrust valuable data to it.
  42. If you have any problems or comments, please leave me E-mail at
  43. 70277.726.              Enjoy, Carlos Weber